Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Enhancing Movie Playback Performance

GetMovieActiveSegment

Use the GetMovieActiveSegment function to determine what portion of a movie is currently active for playing.

pascal void GetMovieActiveSegment (Movie theMovie, 
                                    TimeValue *startTime,
                                    TimeValue *duration);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

startTime

Contains a pointer to a time value. The GetMovieActiveSegment function places the starting time of the active segment into the field referred to by this parameter. If the returned time value is set to -1, the entire movie is active. In this case, the Movie Toolbox does not return any duration information via the duration parameter.

duration

Contains a pointer to a time value. The GetMovieActiveSegment function places the duration of the active movie segment into the field referred to by this parameter. If the entire movie is active (the returned starting time is set to -1), the Movie Toolbox does not return any duration information.

DESCRIPTION

Your application can set the active segment by calling the SetMovieActiveSegment function, which is described in the previous section.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid